Notification > KakaoTalk Bizmessage > エラーコード

APIレスポンスコード

service isSuccess resultCode resultMessage
共通 true 0 成功
共通 false 4 パラメータ検証に失敗しました(resultMessageを参照)
共通 false -1000 無効なアプリケーションキー
共通 false -1001 無効なシークレットキー(secretKey)
共通 false -1002 無効なSMSアプリケーションキー
共通 false -1003 無効なSMS発信番号
共通 false -1004 すでに登録されているプラスフレンド
共通 false -1005 10分間、同じX-NC-API-IDEMPOTENCY-KEY値でメッセージ送信を要求した場合
共通 false -1008 プラスフレンドトークンの登録失敗
共通 false -1010 발신프로필 그룹이 존재하지 않을 경우
共通 false -1013 이미 존재하는 발신프로필 그룹일 경우
共通 false -1014 無効な事業者登録番号
共通 false -1016 メッセージが見つからない場合
共通 false -1017 一日の送信量を超過したため送信失敗
共通 false -1018 事業者登録証ファイルが存在しない場合
共通 false -1019 事業者登録証ファイルが存在しない場合
共通 false -1022 발신프로필이 그룹에 등록되지 않은 발신프로필일 경우
共通 false -1023 발신프로필이 그룹이 최대 10개가 초과한 경우
共通 false -1024 발신프로필이 그룹으로 메시지를 발송할 경우
共通 false -1025 발신프로필 삭제 API로 발신프로필 그룹 삭제 시도한 경우
共通 false -1026 발신프로필 그룹의 멤버가 5000개가 초과한 경우
共通 false -1027 발신프로필이 차단 상태일 경우
共通 false -1028 템플릿 변수가 치환될 때 그 차이가 14개 글자를 초과하는 부분이 있는 경우(최초 사용자 제한)
共通 false -1029 그룹 프로필에 멤버로 추가할 수 없는 경우(최초 사용자 제한)
共通 false -1030 본인인증을 받지 않은 경우
共通 false -2000 特定フィールドの値が最大の長さより大きい場合
共通 false -2001 特定フィールドの値が空白の場合
共通 false -2002 特定フィールドの値がNULLの場合
共通 false -2003 特定フィールドの値が最小の長さより小さい場合
共通 false -2017 存在しないプラスフレンド
共通 false -2018 無効なボタンパラメータ
共通 false -2019 テンプレート本文が1,000文字を超えたため失敗
共通 false -2022 イメージを添付しましたが、イメージリンク(imageLink)を入力していない場合
共通 false -2023 カカともへのメッセージのメッセージ本文が400文字を超える場合(イメージ添付)
共通 false -2024 カカともへのメッセージのメッセージ本文が1,000文字を超える場合
共通 false -2025 予約日時が過去の日時の場合
共通 false -2026 予約日時が90日以上先の日時の場合(最大90日まで可能)
共通 false -2027 日付フォーマットが異なるため解析エラー発生
共通 false -2028 無効なリクエストID
共通 false -2029 リクエストしたメッセージがないか、キャンセルできるメッセージがない場合
共通 false -2030 와이드 이미지 발송 시, 최대 본문 길이 76자 초과한 경우
共通 false -2031 와이드 이미지 발송 시, 최대 버튼 개수 2개 초과한 경우
共通 false -2032 템플릿 제목이 50자를 초과한 경우
共通 false -2033 템플릿 아이템 파라미터가 유효하지 않은 경우
共通 false -2034 템플릿 아이템 하이라이트 파라미터가 유효하지 않은 경우
共通 false -2035 템플릿 헤더가 16자를 초과한 경우
共通 false -2036 TemplateRepresentLink 파라미터가 유효하지 않은 경우
共通 false -2037 아이템 리스트 포함 템플릿 등록 시 메시지 본문 글자 수가 700자를 초과한 경우
共通 false -2500 대량 발송 요청을 찾을 수 없는 경우
共通 false -2501 요청한 메시지가 없거나, 취소할 수 있는 메시지가 없는 경우
共通 false -2502 送信失敗設定がされていない状態で、代替送信をリクエストした場合
共通 false -2504 유효하지 않은 바로연결
共通 false -2505 바로연결 포함 발송 시, 최대 버튼 개수 2개를 초과한 경우
共通 false -2999 送信リクエストしたすべての受信者のリクエスト失敗
共通 false -3000 自由ボタンタイプのテンプレートの場合、ボタン名/モバイルリンク(linkMo)は必須値です。
共通 false -3001 すでに存在するテンプレートコードまたはテンプレート名
共通 false -3002 必要なリクエスト本文(request body)内容を読み込めない場合
共通 false -3003 存在しないテンプレート
共通 false -3004 送信するテンプレートパラメータエラー
共通 false -3005 テンプレート状態エラー(承認前に送信リクエストした時)
共通 false -3006 ボタンURLは必ずhttp://またはhttps://を含める必要があります。
共通 false -3007 自由ボタンタイプのテンプレートのみボタン名とボタンURLの入力が可能です。
共通 false -3008 配送照会ボタンタイプはボタンURLを入力できません。
共通 false -3009 ボタン名が存在しません。
共通 false -3010 テンプレート本文が一致しません。
共通 false -3011 テンプレートボタンが存在しません。
共通 false -3012 修正できないテンプレート状態(承認/差し戻し状態のみ可能)
共通 false -3013 すでに修正中のテンプレートが存在
共通 false -3014 ボタンタイプが正しくない場合
共通 false -3015 CBT機能が無効になっているプラスフレンドの場合
共通 false -3016 強調表記型テンプレートはtemplateTitle、templateSubtitleが必須フィールド
共通 false -3017 templateSubtitleは置換変数を使用不可
共通 false -3018 付加情報型テンプレートはtemplateExtraが必須フィールド
共通 false -3020 複合型テンプレートはtemplateExtra、templateAdが必須フィールド
共通 false -3021 templateExtraは置換変数を使用不可
共通 false -3024 ACタイプボタンは広告追加型、複合型テンプレートのみ登録可能
共通 false -3025 AC 타입 버튼은 단독으로 사용하거나, 가장 위에 위치해야하는 제약에 어긋난 경우
共通 false -3026 AC 타입 버튼의 이름은 "채널 추가" 만 등록 가능
共通 false -3027 템플릿 강조 표시 타입 기본(NONE)로 등록 시, templateTitle, templateSubtitle 필드를 등록할 수 없
共通 false -3028 템플릿 메시지 유형 기본형(BA)일 경우, templateExtra 필드를 등록할 수 없음
共通 false -3030 템플릿 메시지 유형 채널 추가형(AD)일 경우, templateExtra 필드를 등록할 수 없음
共通 false -3031 그룹 템플릿은 템플릿 메시지 유형 채널추가형(AD), 복합형(MI)를 사용할 수 없음
共通 false -3032 템플릿 강조 표시 타입 이미지형(IMAGE)일 경우, templateImageName, templateImageUrl 필드 필수값
共通 false -3033 버튼 또는 바로연결이 템플릿에 등록되지 않았을 경우
共通 false -3034 삭제할 템플릿이 3일이내 발송 이력이 있을 경우
共通 false -3035 템플릿 강조 표시 타입 아이템리스트형(ITEM_LIST)로 등록 시, templateHeader, templateImageName, templateImageUrl, templateItem, templateItemHighlight 필드 중 1개 이상 필수로 포함
共通 false -3036 템플릿 강조 표시 타입 아이템리스트형(ITEM_LIST)로 등록 시, 보안 템플릿으로 등록할 수 없음
共通 false -3037 templateItem list의 title은 치환 변수를 가질 수 없음
共通 false -3038 templateItem summary의 title은 치환 변수를 가질 수 없음
共通 false -3039 templateItem summary은 templateItem list없이 존재할 수 없음
共通 false -3040 아이템하이라이트의 title은 최대 21글자, description은 최대 13글자
共通 false -3041 imageUrl은 http:// https:// 프로토콜을 반드시 포함해야 함
共通 false -3042 templateHeader이 템플릿과 일치하지 않는 경우
共通 false -3043 templateItem 또는 templateItemHighlight이 템플릿과 일치하지 않는 경우
共通 false -3044 비지니스폼(BF) 타입 버튼은 단독으로 사용하거나, 가장 위에 위치해야하는 제약에 어긋난 경우
共通 false -3045 비지니스폼(BF) 타입의 name이 "톡에서 예약하기", "톡에서 설문하기", "톡에서 응모하기" 이 아닐 경우, 또는 등록되지 않은 bizFormKey일 경우
共通 false -4003 照会範囲が1か月を超過
共通 false -4004 存在しないアプリケーションキー
共通 false -4005 使用終了状態のアプリケーションキー
共通 false -4007 ファイルサイズ超過
共通 false -4009 유효하지 않은 파일 확장자
共通 false -4015 無効なリクエストID(requestId)
共通 false -4101 無効な統計照会パラメータ
共通 false -4103 照会時、送信リクエスト開始時間/送信リクエスト終了時間値がない場合
共通 false -4200 無効な代替送信メッセージ
共通 false -5000 無効な受信番号

| 共通 | false | -6000 | 고정형(F) 내용 유형은 변수를 포함할 수 없음 | | 共通 | false | -6001 | 변수형(V) 내용 유형은 반드시 변수를 포함해야 함 | | 共通 | false | -6002 | 변수는 총 20개 이상 포함할 수 없음 | | 共通 | false | -6003 | 변수는 영문/숫자/특수문자('-', '')만 사용할 수 있으며 20자 이내로만 가능 | | 共通 | false | -6004 | 와이드형(W) 메시지 타입은 본문 76자 이내, 버튼 2개까지 가능 | | 共通 | false | -6005 | 채널 추가(AC) 타입 버튼은 이미지형(I) 메시지 타입일 경우, 첫 번째 순서에 위치해야 합니다.
와이드형(W) 메시지 타입일 경우, 마지막에 위치해야 합니다. | | 共通 | false | -6006 | 비지니스폼(BF) 타입 버튼은 bizFormId 값이 반드시 존재해야 합니다.
이미지형(I) 메시지 타입일 경우, 첫 번째 순서에 위치해야 합니다.
와이드형(W) 메시지 타입일 경우, 마지막에 위치해야 합니다.
이미지형(I) 메시지 타입이면서 채널 추가(AC) 타입 버튼과 같이 사용할 경우, 두 번째에 위치해야 합니다.
와이드형(W) 메시지 타입이면서 채널 추가(AC) 타입 버튼과 같이 사용할 경우, 첫 번째에 위치해야 합니다. |

| 共通 | false | -7000 | ベンダーリクエストAPI失敗 | | 共通 | false | -8000 | イメージシーケンス(imageSeq)がない場合 | | 共通 | false | -8001 | イメージファイルが正常ではない場合 | | 共通 | false | -8002 | イメージシーケンス(imageSeq)に対応するイメージがない場合 | | 共通 | false | -8003 | イメージの削除に失敗した場合 | | 共通 | false | -8004 | createUser 필드 최대 100자를 초과한 경우 | | 共通 | false | -8005 | イメージをアップロードした時、プロジェクトに登録されたプラスフレンドがいない場合 | | 共通 | false | -8006 | 認証メッセージ送信時、テンプレート内容に認証文言がない場合 | | 共通 | false | -8008 | メッセージを送信すると、メッセージの内容に禁止されている単語が含まれていました。 | | 共通 | false | -8010 | 네트워크 등의 문제로 이미지 파일 업로드 실패 | | 共通 | false | -9995 | fade-outしたバージョンのAPIを呼び出した場合 | | 共通 | false | -9996 | Content-typeがapplication/jsonではない場合 | | 共通 | false | -9997 | 不適切なリクエストによる失敗 | | 共通 | false | -9998 | 存在しないAPI | | 共通 | false | -9999 | システムエラー |

送信結果コード

コード値 意味
1000 成功
1001 Request Body가 Json형식이 아님
1002 허브 파트너 키가 유효하지 않음
1003 発信プロフィールキーが無効
1004 Request Body(JSON)でnameが見つからない
1006 削除された発信プロフィール(サポートに問い合わせ)
1007 遮断状態の発信プロフィール(サポートに問い合わせ)
1011 契約情報が見つからない(サポートに問い合わせ)
1012 無効な形式のユーザーキーリクエスト
1013 無効なアプリ接続
1014 無効な事業者番号
1015 無効なapp user idリクエスト
1016 事業者登録番号の不一致
1021 遮断状態のカカオトークチャンネル
1022 닫힘 상태의 카카오톡 채널
1023 削除されたカカオトークチャンネル
1024 削除待機状態のカカオトークチャンネル
1025 채널 제재 상태로 인한 메시지 전송 실패
1027 채널 메시지 제재 상태로 인한 메시지 전송 실패
1030 無効なパラメータリクエスト
2000 送信時間超過
2001 メッセージ送信不可(予期せぬエラー発生)
3000 予期せぬエラー発生
3005 メッセージを送信したが受信確認不可(成功不確実、サーバーには暗号化されて保管され、3日間受信可能)
3006 内部システムエラーでメッセージ転送失敗
3008 電話番号エラー
3009 メッセージ形式エラー
3010 予期せぬエラー発生
3011 メッセージが存在しない
3012 カカオ通信失敗
3013 メッセージが空
3014 メッセージの長さ制限エラー
3015 テンプレートが見つからない
3016 メッセージの内容がテンプレートと一致しない
3018 メッセージを送信できない
1. カカオトークを使用していたが退会した人
2. カカオトークに一度も登録したことがない人
3. お知らせトーク受信遮断
4. Androidユーザーの場合、「携帯電話のUSIMとカカオトーク使用番号」が異なる人
5. アクティブユーザーではない場合(pushに該当)
6. カカオトーク最低使用バージョンおよびカカオトーク未サポート、制裁ユーザーなど
3022 発送可能な時間ではない(友達トークメッセージは08時から20時50分までに発送します)
3023 メッセージ文法エラー(JSON形式エラー)
3024 메시지에 포함된 이미지를 전송할 수 없음(이미지주소 또는 링크가 올바르지 않거나 이미지가 규격에 맞지 않음)
3025 変数の文字数制限超過
3026 상담/봇 전환 버튼 extra, event 글자수 제한 초과
3027 メッセージのボタン/直接接続がテンプレートと一致しない
3028 メッセージ強調表記タイトルがテンプレートと一致しない
3029 メッセージ強調表記タイトルの長さ制限超過(50文字)
3030 메시지 타입과 템플릿 강조유형이 일치하지 않음
3031 헤더가 템플릿과 일치하지 않음
3032 헤더 길이 제한 초과(16자)
3033 아이템 하이라이트가 템플릿과 일치하지 않음
3034 아이템 하이라이트 타이틀 길이 제한 초과(이미지 없는 경우 30자, 이미지 있는 경우 21자)
3035 아이템 하이라이트 디스크립션 길이 제한 초과(이미지 없는 경우 19자, 이미지 있는 경우 13자)
3036 아이템 리스트가 템플릿과 일치하지 않음
3037 아이템 리스트의 아이템의 디스크립션 길이 제한 초과(23자)
3038 아이템 요약정보가 템플릿과 일치하지 않음
3039 아이템 요약정보의 디스크립션 길이 제한 초과(14자)
3040 아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함(통화기호/코드, 숫자, 콤마, 소수점, 공백을 제외한 문자 포함)
3042 대표링크가 템플릿과 일치하지 않음
3051 케러셀 아이템 리스트 갯수 최소, 최대 갯수 불일치
3052 케러셀 아이템 메시지 길이 초과
4000 メッセージ転送結果が見つからない
4001 不明なメッセージ状態
9998 システムに問題が発生して担当者が確認中(現在サービス提供中ではない)
9999 システムに問題が発生して担当者が確認中(システムに不明なエラー発生)

브랜드톡 발송 결과 코드

코드값 의미
A0000 성공
A1001 Request Body가 JSON형식이 아님
A1003 발신 프로필 키가 유효하지 않음
A1004 Request Body(JSON)에서 name을 찾을 수 없음
A1006 삭제된 발신프로필
A1007 차단 상태의 발신프로필
A1021 차단 상태의 카카오톡 채널
A1022 닫힘 상태의 카카오톡 채널
A1023 삭제된 카카오톡 채널
A1024 삭제대기 상태의 카카오톡 채널
A1025 메시지차단 상태의 카카오톡 채널
A1030 잘못된 파라메터 요청
A1033 템플릿 타입과 메시지타입 불일치
A2040 동보발송 요청이 진행중이라서 타겟팅 값을 사용할 수 없음
A3000 예기치 않은 오류 발생
A3006 내부 시스템 오류로 메시지 전송 실패
A3008 전화번호 오류
A3010 Json 파싱 오류
A3011 메시지가 존재하지 않음
A3013 메시지가 비어 있음
A3014 메시지 길이 제한 오류(템플릿별 제한 길이 또는 1000자 초과)
A3015 템플릿을 찾을 수 없음
A3016 메시지 내용이 변수와 일치하지 않음
A3018 메시지를 전송할 수 없음
A3020 메시지 확인 정보를 찾을 수 없음
A3022 메시지 발송 가능한 시간이 아님(브랜드톡/마케팅 메시지는 08시부터 20시까지 발송 가능)
A3024 메시지에 포함된 이미지를 전송할 수 없음
A3027 버튼이 변수와 일치하지 않음
A3031 텍스트 유형 불일치
A4000 메시지 전송 결과를 찾을 수 없음
A4001 알 수 없는 메시지 상태
A9998 시스템에 문제가 발생하여 담당자가 확인하고 있는 경우
A9999 시스템에 문제가 발생하여 담당자가 확인하고 있는 경우
B7013 발송 제약 시간(20:50~익일 08:00) 에러
B7014 메시지 유효 시간 초과 에러
B7015 메시지 길이 제한 오류
B7017 내부 시스템 오류로 메시지 전송 실패
TOP